home *** CD-ROM | disk | FTP | other *** search
Text File | 1998-01-21 | 74.2 KB | 1,585 lines
XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555)))) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) NNNNAAAAMMMMEEEE xgopher - gopher client for the X window system SSSSYYYYNNNNTTTTAAAAXXXX xxxxggggoooopppphhhheeeerrrr [_r_o_o_t _s_e_r_v_e_r [_s_e_r_v_e_r _p_o_r_t]] [-_t_o_o_l_k_i_t_o_p_t_i_o_n ...] DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN _x_g_o_p_h_e_r is an X window system client interface to the gopher information server. Xgopher provides access to tremendous amounts of information which may be accessed from a local system or a remote information server. The source of the information is generally transparent, with data supplied from world-wide locations as easily as from a local on- campus server. The Gopher information system software is from the University of Minnesota. OOOOPPPPTTTTIIIIOOOONNNNSSSS The installer of Xgopher normally configures the _r_o_o_t _s_e_r_v_e_r and _s_e_r_v_e_r _p_o_r_t options. Loosely speaking, the root server is the network name of the computer system that will provide your initial gopher menu. The port is a number that specifies system connection information. These options may also be specified via the resources described later in this document. For convenience, these options may be specified on the command line. The X toolkit options are standard options available to every application written using the X toolkit (Xt). Please refer to your Xt documentation for a list and description of these options. MMMMAAAAIIIINNNN DDDDIIIISSSSPPPPLLLLAAAAYYYY PPPPAAAANNNNEEEELLLL The initial display will show the top level directory of gopher information available. Selecting an item from this list will fetch the contents of a file, subdirectory, or other information. The directory display may be updated to show the new subdirectory. A gopher item is a menu entry in this directory list. There are many types of gopher items handled by Xgopher, and each is explained below. An item is selected and highlighted by pointing at an entry with the mouse and clicking the left button. To unselect all items, click the mouse in either the directory title area or bookmark title area. You may select an entry in either the upper directory list item or the lower bookmark list. The display button marked Page 1 (printed 8/30/95) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555)))) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) FFFFeeeettttcccchhhh sssseeeelllleeeeccccttttiiiioooonnnn is used to act on the selection. An accelerator allows you to simply "click" a second time on a highlighted item to activate the fetch. By default, all interactions use only the left mouse button. A directory is a collection of other files and directories. The directory items are displayed in a list with an identifying symbol to the left of each item. The symbol identifies the type of the item. The symbols may be changed by the installer or by each user. The default symbols are: blank Text file >> directory <cso> a CSO name server (phone book) <idx> a full text index search <tel> a telnet session <tn3> a tn3270 session <img> an image file <bin> a binary file <snd> a sound file (spoken, sound effect, or music) The file types are discussed below. From all but the top level directory, the PPPPrrrreeeevvvviiiioooouuuussss DDDDiiiirrrreeeeccccttttoooorrrryyyy button will return you to the previous directory that was displayed just before this one. A keyboard accelerator allows you to press the "u" key while the X pointer is anywhere on the main panel to achieve the same action. BBBBOOOOOOOOKKKKMMMMAAAARRRRKKKKSSSS If you are viewing a directory that you may wish to return to later, set a bookmark there with the AAAAdddddddd ddddiiiirrrreeeeccccttttoooorrrryyyy aaaassss bbbbooooooookkkkmmmmaaaarrrrkkkk button. This directory will be displayed with your other bookmarks in the lower scrolling region below the current directory list. If you already have an item selected, the buttons label will now read AAAAdddddddd sssseeeelllleeeeccccttttiiiioooonnnn aaaassss bbbbooooooookkkkmmmmaaaarrrrkkkk and the item will be added to the bookmark list. Later, no matter where you have browsed through the gopher directory space, you may return to any bookmark by selecting Page 2 (printed 8/30/95) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555)))) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) it just as you would a regular directory item. You are brought immediately to that marked directory, The directory that you were in when you selected the bookmark becomes the previous directory. Other buttons and menu items let you remove individual bookmarks or all of the bookmarks. The main gopher directory that you see when you first start Xgopher is normally marked for you so you can easily and quickly return to the top level. Bookmarks are normally saved between your Xgopher sessions. When your start Xgopher, the file $HOME/.gopherrc is read to load your previous bookmarks, if any. When you exit Xgopher, your current bookmark list is written back to this file. Using the OOOOppppttttiiiioooonnnn ppppaaaannnneeeellll described below, you can change the name of your bookmark file any number of times during an Xgopher session, and use the LLLLooooaaaadddd bbbbooooooookkkkmmmmaaaarrrrkkkkssss nnnnoooowwww and SSSSaaaavvvveeee bbbbooooooookkkkmmmmaaaarrrrkkkkssss nnnnoooowwww commands to manipulate several files of bookmarks. The bookmark save file should be compatible with the Unix curses client, bookmark file. Other resources described below that may affect bookmark processing are: bbbbooooooookkkkmmmmaaaarrrrkkkkFFFFiiiilllleeee,,,, llllooooaaaaddddBBBBooooooookkkkmmmmaaaarrrrkkkkssss,,,, aaaappppppppeeeennnnddddBBBBooooooookkkkmmmmaaaarrrrkkkkssss,,,, mmmmaaaarrrrkkkkRRRRooooooootttt,,,, and aaaalllllllloooowwwwBBBBooooooookkkkmmmmaaaarrrrkkkkSSSSaaaavvvveeee.... IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN AAAABBBBOOOOUUUUTTTT IIIITTTTEEEEMMMMSSSS Each gopher item and directory may be maintained by a remote computer system anywhere in the world. Sometimes it can be difficult to determine where the information is coming from. You can at least display the raw information which includes the name of the computer (host) that serves each gopher item. If you are viewing a directory with no items currently selected click the button labeled IIIInnnnffffoooo aaaabbbboooouuuutttt ddddiiiirrrreeeeccccttttoooorrrryyyy, and the information for this directory will be displayed. If you already have an item selected, the buttons label will now read IIIInnnnffffoooo aaaabbbboooouuuutttt sssseeeelllleeeeccccttttiiiioooonnnn and information about the selected item will be shown. The item that you select may be from either the directory list or the bookmark list. GGGGOOOOPPPPHHHHEEEERRRR IIIITTTTEEEEMMMM TTTTYYYYPPPPEEEESSSS TTTTEEEEXXXXTTTT DDDDIIIISSSSPPPPLLLLAAAAYYYYSSSS When the item selected from the directory list is a text file, the contents of the file are fetched and Page 3 (printed 8/30/95) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555)))) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) displayed as a pop-up text display window. Help information is displayed in this way also. The text display shows several command buttons and the text itself in a vertically scrolling window. The buttons are: DDDDoooonnnneeee to release this text file and window, PPPPaaaaggggeeee ddddoooowwwwnnnn to position the text down one page, PPPPaaaaggggeeee uuuupppp to position the text up one page, PPPPrrrriiiinnnntttt to send the contents of this file to the printer, SSSSaaaavvvveeee to save the contents of this file in a user-specified file. The PPPPrrrriiiinnnntttt or SSSSaaaavvvveeee buttons may not always be available. They may be disallowed by the installer or system-wide resources file for Xgopher. Text displays use the text widget from the MIT-supplied Athena widget set. The text is given a read-only attribute, but all of the position, search, and selection capabilities of the widget are available. For the user who knows how to use these functions, there is this additional power. For example, entering control-S from the keyboard will bring up a text search panel allowing you to scan for any string in the file. Other control sequences allow more flexible text positioning than is provided by the scroll bar and paging buttons. All of these options are described in the Athena widget set documentation of the text widget. CCCCSSSSOOOO NNNNAAAAMMMMEEEE SSSSEEEERRRRVVVVEEEERRRR ((((PPPPhhhhoooonnnneeee BBBBooooooookkkk)))) When the item selected is a CSO name server, a new window is displayed on the X display. The name of the institution supporting the name server is displayed at the top of the window. Below this are 4 areas. First are the control buttons: Done closes the CSO name server window; HHHHeeeellllpppp provides a text display with additional information; and SSSShhhhoooowwww FFFFiiiieeeellllddddssss, discussed below. The next area is a single line text entry field where you type the name of the person you are looking up. The name server will usually be able to find someone by first name, last name, or both. Although, overly general searches are prohibited. For example, trying to look up "smith" is probably not a good idea in most of the United States. After entering the name, type a carriage return (enter) or click the mouse on the DDDDoooo qqqquuuueeeerrrryyyy button to submit the request. Additional buttons in the third area allow you to clear the query or result text areas. The result is displayed in the Page 4 (printed 8/30/95) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555)))) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) forth area, the bottom scrolling text region. The SSSShhhhoooowwww FFFFiiiieeeellllddddssss button displays a pop up menu. Select an item from this menu to list the names and a brief description of the fields in the data base being searched. Note that these fields may be different for every institution! Listing ddddeeeeffffaaaauuuulllltttt fields will show the things that are returned for a normal query (usually name, address, phone number, department, plus others). IIIInnnnddddeeeexxxxeeeedddd fields are those that you can use to search for (usually name and perhaps office phone). LLLLooooooookkkkuuuupppp fields are those that can be used to narrow the search (for example, department). Finally, PPPPuuuubbbblllliiiicccc fields are all the fields that can be viewed by everyone. A query may include more than just a name, for example, legitimate queries are: john smith This will return every John Smith in the selected data base. If there are more than a handful, the name server will complain that there are too many to give you. In this case, you may want to try the next example. smith department=biology The department will help narrow the search to only those people in the department of biology. j* smith department=biology A "*" matches any characters and will help if you are not sure of the exact spelling of a name or only know initials. john smith department=biology return all The return option may specify a field you are interested in or the value "all" to get all public fields returned. The CSO name server window may be left on the X display as long as you like. Once displayed, it operates independent of the gopher directory traversal. If you want to switch to search another institution's phone directory you can select it from the appropriate directory list without first closing a prior CSO name server window. The same window is re-used for the Page 5 (printed 8/30/95) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555)))) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) currently selected institution. IIIINNNNDDDDEEEEXXXX SSSSEEEEAAAARRRRCCCCHHHH An index search is a very powerful way of obtaining a list of documents which contain (or do not contain) certain words. When you select an index search item, a small pop-up panel asks you for a list of search words. You can enter one or more words, plus the special reserved boolean operators aaaannnndddd, oooorrrr, and nnnnooootttt. For example, if you want information on setting certain terminal parameters for Unix, you may enter: terminal and setting or tset which will find all documents in the search space which contain both the words "terminal" and "setting", or the word "tset". The "or" is non-exclusive so the document may contain all of the words. The input words may be in upper- or lower-case, and will match words of either case. After entering the words, press carriage return (enter) or click the mouse on the DDDDoooo qqqquuuueeeerrrryyyy button and the search will be carried out. The result of the index search looks very much like a normal gopher directory of text files, but each file is one that matches your specified criterion. You will see a difference in the display of the text file, however. Every word (or part of a word) that matches the index words will be highlighted in the text display. This allows you to quickly locate the parts of a document that are interesting to you. TTTTEEEELLLLNNNNEEEETTTT SSSSEEEESSSSSSSSIIIIOOOONNNN Telnet sessions are normally text-based information services, for example access to University library holdings. When you select an item which is identified as a telnet session, A new xterm window (normal terminal emulator window) will be created and it will be running a telnet session. It may take a few seconds for the xterm window to show up. Some hosts that you connect to may require you to enter a username (login name). If so, then Xgopher will pop up an information window showing you the name to use once the telnet session is started. Many telnet sessions require you to enter a terminal type as a part of the startup interaction. Usually, Page 6 (printed 8/30/95) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555)))) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) you should choose vvvvtttt111100000000, as the xterm commands are very similar to that of a DEC VT100 terminal. Telnet sessions may be disallowed by the aaaalllllllloooowwwwTTTTeeeellllnnnneeeetttt resource described below. If telnet sessions are not allowed, an error message will be displayed to that effect. TTTTNNNN3333222277770000 SSSSEEEESSSSSSSSIIIIOOOONNNN tn3270 sessions are normally text-based information services; similar in concept to telnet sessions, but using a different terminal emulation protocol. When you select an item which is identified as a tn3270 session, A new xterm window (normal terminal emulator window) will be created and it will be running a tn3270 session. It may take a few seconds for the xterm window to show up. Some hosts that you connect to may require you to enter a username (login name). If so, then Xgopher will pop up an information window showing you the name to use once the tn3270 session is started. tn3270 sessions may be disallowed by the aaaalllllllloooowwwwTTTTnnnn3333222277770000 resource described below. If tn3270 sessions are not allowed, an error message will be displayed to that effect. For the X window system, X3270 is an alternative to tn3270 that many people prefer. Whereas tn3270 executes as an application within an xterm window and doesn't understand X at all, X3270 is a true X application. tn3270 is available (vendor-supplied) on most Unix systems. X3270 is publicly available software, but not supplied as a part of Xgopher. If your site provides the X3270 program, you may use it instead of tn3270. The IBM 3278 terminal character set and behavior is closely emulated by X3270. Colors are used to distinguish normal, bold, and input fields. Every key on the keyboard may be mapped to a 3278 function using one of the supplied keyboard maps or the X application defaults file. The following commands are usually built into Xgopher or the system resources file when the program is installed, but you may modify your own application resources to use a command such as the following for tn3270: Page 7 (printed 8/30/95) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555)))) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) xterm -e tn3270 or aixterm -e tn3270 (for IBM AIX systems) If you choose X3270 instead, the command is: x3270 IIIIMMMMAAAAGGGGEEEESSSS When an image file is selected for processing, Xgopher retrieves the file, then runs another program to display the image on an X display. This second program is often _x_l_o_a_d_i_m_a_g_e. The installer of Xgopher, or any user, may change this to be any other program that is available. _x_l_o_a_d_i_m_a_g_e is a particularly nice program because it will display other file types besides GIF using heuristics to determine the type of the file. The iiiimmmmaaaaggggeeeeCCCCoooommmmmmmmaaaannnndddd resource specifies the command that will be used to display the image. Interesting choices are: xloadimage (normal behavior, with messages output) xloadimage -quiet(the Xgopher default - no messages) xv (another nice gif viewer available) Neither _x_l_o_a_d_i_m_a_g_e nor _x_v are a part of the Xgopher distribution. Many sites that run X already have one of these programs installed. A large image may take many seconds to appear as considerable processing may be required before the display. Several images may be displayed at once. The way to remove an image depends on the command used to display the image. For _x_l_o_a_d_i_m_a_g_e, typing the letter "q" within the picture display will remove the image. The aaaalllllllloooowwwwIIIImmmmaaaaggggeeee resource may be used to disallow processing of image files. BBBBIIIINNNNAAAARRRRYYYY FFFFIIIILLLLEEEESSSS Binary file types are not precisely defined in the gopher community, but many Unix files that are compressed (.Z) or tar archives (.tar) are assigned the same binary item type in gopher (type 9). When you select one of these files, Xgopher prompts you for a file name on your local system. The dialog box that pops up for this file name will suggest the same name Page 8 (printed 8/30/95) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555)))) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) as the remote file; you may change this name if it is not satisfactory. The files are then processed (or fetched) by simply copying the data to your specified file. Processing a binary type of gopher item with the FFFFeeeettttcccchhhh sssseeeelllleeeeccccttttiiiioooonnnn button is identical to using the CCCCooooppppyyyy command on the same item. The aaaalllllllloooowwwwCCCCooooppppyyyy resource determines whether copying is allowed. If not, a message is displayed. SSSSOOOOUUUUNNNNDDDDSSSS If Xgopher is executing on a workstation that supports sounds, then you can play files containing spoken words, sound effects, or music through Xgopher. Selecting a sound file will cause that file to be "played" through your workstation's audio device. Only a single sound file can be active at a time; you will be warned if you try to play a sound before a previous one is through. Use the application resources hhhhaaaassssSSSSoooouuuunnnndddd and ssssoooouuuunnnnddddCCCCoooommmmmmmmaaaannnndddd described below. Note that your X display may be remote from the computer that is executing the Xgopher application. Your sounds may be coming across loud and clear on a computer system some distance away from your display. CCCCOOOOPPPPYYYYIIIINNNNGGGG FFFFIIIILLLLEEEESSSS DDDDIIIIRRRREEEECCCCTTTTLLLLYYYY The Copy item in the Other Commands menu can be used to copy a gopher item directly to a file without first processing or displaying the gopher data. If the item type is a text file, an ascii mode copy will be done, preserving end-of- line conventions for your system. Other data files and unknown item types are copied in binary mode until an end of file is encountered. It makes no sense to copy directories, CSO name servers, index directories, or telnet sessions, so the copy command will reject requests to copy these. When you chose the CCCCooooppppyyyy command, Xgopher prompts you for a file name on your local system. The dialog box that pops up for this file name will suggest the same name as the remote file; you may change this name if it is not satisfactory. The ccccooooppppyyyy command is one way to access gopher item types that are not normally processed by Xgopher. If the aaaalllllllloooowwwwCCCCooooppppyyyy resource is false, then the ccccooooppppyyyy command is not shown in the menu. DDDDIIIIRRRREEEECCCCTTTT EEEENNNNTTTTRRRRYYYY OOOOFFFF AAAA GGGGOOOOPPPPHHHHEEEERRRR IIIITTTTEEEEMMMM This function is not for the beginning or casual user of Page 9 (printed 8/30/95) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555)))) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) Gopher. Sometimes a reference is available to a specific gopher item available, perhaps without specifying all the menus to traverse. If you know all the access information for a piece of data anywhere in gopher space, you may use the EEEEnnnntttteeeerrrr GGGGoooopppphhhheeeerrrr IIIItttteeeemmmm command in the OOOOtttthhhheeeerrrr CCCCoooommmmmmmmaaaannnnddddssss menu to directly access this data. When you select this command a panel is displayed for you to enter the type, path, host, port, and optionally name of the item. A help display is available to explain these items a bit more. A neat trick: Any gopher data can be fetched as a text file by entering its host/path/port and setting the type to 0 (ascii text file). Even a directory can be fetched as text in this way. Similarly, any gopher data may be retrieved as binary by setting the type to 9 (binary file type). This works even for types unknown to Xgopher. OOOOPPPPTTTTIIIIOOOONNNNSSSS PPPPAAAANNNNEEEELLLL Some Xgopher options may be changed during a session. These are available on the OOOOppppttttiiiioooonnnnssss PPPPaaaannnneeeellll pop up display which is selected from the OOOOtttthhhheeeerrrr CCCCoooommmmmmmmaaaannnnddddssss menu. The bookmark file, and system commands for printing, image display, and telnet sessions may be changed using this panel. A help display is available with this panel to further describe the options. If the ooooppppttttiiiioooonnnnssssBBBBuuuuttttttttoooonnnn resource is false, then the OOOOppppttttiiiioooonnnnssss PPPPaaaannnneeeellll command is not shown in the menu. RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS The application class is XXXXggggoooopppphhhheeeerrrr. Most of the user- interface is configured in the app-defaults file; if this file is missing a warning message will be printed to standard error and the program will terminate. All of the important defaults are established in the system app- defaults file, normally installed as /usr/lib/X11/app- defaults/Xgopher. The defaults mentioned below may have been changed by the installer for a specific system. They may all be overridden in by individual preferences. The application specific resources are grouped below by category. SSSSttttaaaarrrrttttuuuupppp rrrroooooooottttSSSSeeeerrrrvvvveeeerrrr ((((class RRRRoooooooottttSSSSeeeerrrrvvvveeeerrrr)))) Specifies the initial gopher information server host name as an internet address. rrrroooooooottttPPPPoooorrrrtttt ((((class RRRRoooooooottttPPPPoooorrrrtttt)))) Page 10 (printed 8/30/95) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555)))) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) The port number of the top level gopher server to connect to. The supplied default is 70. rrrroooooooottttPPPPaaaatttthhhh ((((class RRRRoooooooottttPPPPaaaatttthhhh)))) The initial selector string or path name to retireve the top level menu. The supplied default is the null string. hhhheeeellllppppFFFFiiiilllleeee ((((class HHHHeeeellllppppFFFFiiiilllleeee)))) This is the absolute or relative path name of the file to be displayed when the _h_e_l_p command button is depressed. The supplied default is /usr/lib/X11/xgopher/xgopher.help mmmmaaaaiiiinnnnTTTTiiiittttlllleeee ((((class MMMMaaaaiiiinnnnTTTTiiiittttlllleeee)))) The main title displayed above the listing of the top level directory. The supplied default is "UIUC Gopher Information Service". bbbbooooooookkkkmmmmaaaarrrrkkkkFFFFiiiilllleeee ((((class bbbbooooooookkkkmmmmaaaarrrrkkkkFFFFiiiilllleeee)))) The name of the file containing Xgopher bookmarks. This is also the file that bookmarks will be written to when you exit Xgopher. This file name may be changed during a session using the options panel. Unlike other file names, if the path name does not have a leading slash or tilde then the path name is assumed relative to your home directory. The supplied default is "~/.gopherrc". llllooooaaaaddddBBBBooooooookkkkmmmmaaaarrrrkkkkssss ((((class llllooooaaaaddddBBBBooooooookkkkmmmmaaaarrrrkkkkssss)))) Whether or not to load bookmarks automatically when Xgopher starts. The supplied default is True. EEEExxxxtttteeeerrrrnnnnaaaallll CCCCoooommmmmmmmaaaannnnddddssss pppprrrriiiinnnnttttCCCCoooommmmmmmmaaaannnndddd ((((class PPPPrrrriiiinnnnttttCCCCoooommmmmmmmaaaannnndddd)))) This is the print command used to spool a print request. Useful examples of print commands are _l_p_r or _e_n_s_c_r_i_p_t. The gopher internal file name containing the text is appended to the end of the command supplied. As an option, if the 2 characters %s appear in the print command string anywhere, they are replaced by the file name. The %s may even appear more than once. If %s appears, then the file name is not appended to the end. The supplied default is: "# print" without the quotes. It is a comment. Page 11 (printed 8/30/95) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555)))) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) tttteeeellllnnnneeeettttCCCCoooommmmmmmmaaaannnndddd ((((class TTTTeeeellllnnnneeeettttCCCCoooommmmmmmmaaaannnndddd)))) The command Xgopher will use to start a telnet session. The host and port number are added to the end of this command. The resulting command is executed (via the _s_y_s_t_e_m(_3) function) to provide a telnet session. In general, the telnet command should be executed by an xterm as with the default (_x_t_e_r_m -_e _t_e_l_n_e_t). In some environments (such as OpenWindows), it may be useful to specify the full path name of both the xterm and telnet commands. For example, /_u_s_r/_b_i_n/_X_1_1/_x_t_e_r_m -_e /_u_s_r/_u_c_b/_t_e_l_n_e_t. This command should be disabled for secure environments such as public access terminals, as it is easy to start a shell from a telnet session. The supplied default is "xterm -e telnet" (without the quotes). ttttnnnn3333222277770000CCCCoooommmmmmmmaaaannnndddd ((((class TTTTnnnn3333222277770000CCCCoooommmmmmmmaaaannnndddd)))) The command Xgopher will use to start a tn3270 session. The host and port number are added to the end of this command. The resulting command is executed (via the _s_y_s_t_e_m(_3) function) to provide a tn3270 session. In general, the tn3270 command should be executed by an xterm as with the default (_x_t_e_r_m -_e _t_n_3_2_7_0). In some environments (such as OpenWindows), it may be useful to specify the full path name of both the xterm and tn3270 commands. For example, /_u_s_r/_b_i_n/_X_1_1/_x_t_e_r_m -_e /_u_s_r/_u_c_b/_t_n_3_2_7_0. This command should be disabled for secure environments such as public access terminals, as it is easy to start a shell from a tn3270 session. Examples of useful tn3270 commands are: Xgopher.tn3270Command: xterm -e tn3270 Xgopher.tn3270Command: aixterm -e tn3270 (for IBM AIX systems) Xgopher.tn3270Command: x3270 The supplied default is "xterm -e tn3270" (without the quotes). iiiimmmmaaaaggggeeeeCCCCoooommmmmmmmaaaannnndddd ((((class IIIImmmmaaaaggggeeeeCCCCoooommmmmmmmaaaannnndddd)))) The command to use to display an image file to the X display screen. The name of the local temporary file containing the image is appended to the end of this command before it is executed. This command is never executed if the aaaalllllllloooowwwwIIIImmmmaaaaggggeeee resource is False. The supplied Page 12 (printed 8/30/95) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555)))) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) default is "xloadimage -quiet" (without the quotes). ssssoooouuuunnnnddddCCCCoooommmmmmmmaaaannnndddd ((((class SSSSoooouuuunnnnddddCCCCoooommmmmmmmaaaannnndddd)))) The command to use to get a sound file from the standard input stream (_s_t_d_i_n) to the audio device. On many workstations this command may be called "_p_l_a_y". Another command which may be useful is "_c_a_t > /_d_e_v/_a_u_d_i_o". The supplied command is started by Xgopher as a separate process with sound data fed into its standard input. This command is never executed if the hhhhaaaassssSSSSoooouuuunnnndddd resource is False. The supplied default is "play" (without the quotes). BBBBeeeehhhhaaaavvvviiiioooouuuurrrr sssshhhhoooowwwwIIIItttteeeemmmmssss ((((class SSSShhhhoooowwwwIIIItttteeeemmmmssss)))) Controls which gopher items will be displayed in the menus. The valid values of this resource are: "All", "Known", "Accessible", or "Available". The value All will display every gopher item returned by the gopher server, even types not understood by Xgopher. Known will display every gopher item that Xgopher can process (including extend types). Accessible will show only those items that the user can fetch or process in this session subject to security resources such as "allowTelnet" which may bar access to certain items. Available items are those that can be processed by pushing the "fetch" button; the intersection of Accessible and Known items. The supplied default is All. aaaappppppppeeeennnnddddBBBBooooooookkkkmmmmaaaarrrrkkkkssss ((((class AAAAppppppppeeeennnnddddBBBBooooooookkkkmmmmaaaarrrrkkkkssss)))) When this resource is true, loading a new bookmark file will append the new bookmarks to your current list. When false, the new bookmarks will replace the current list. The supplied default is True. wwwwaaaarrrrppppCCCCuuuurrrrssssoooorrrr ((((class WWWWaaaarrrrppppCCCCuuuurrrrssssoooorrrr)))) If true, the mouse pointer is automatically positioned by Xgopher whenever a save, index, or CSO name server panel is popped up. The new position is a location within a new window so you can immediately start typing without having to move the mouse. The supplied default is False. ddddoooouuuubbbblllleeeeCCCClllliiiicccckkkk ((((class DDDDoooouuuubbbblllleeeeCCCClllliiiicccckkkk)))) Normally a gopher item or directory is selected by "clicking" on it. Then the _F_e_t_c_h button is Page 13 (printed 8/30/95) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555)))) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) pressed to process the request. If this resource is true, the fetch action may be invoked by simply re-selecting the same item already selected. This is a double-click on that item, although with no time limit between clicks. It may be disabled for example, if a touch sensitive screen replaces the mouse, to ensure more reliable operation. The supplied default is True. ssssttttaaaattttuuuussssWWWWiiiinnnnddddoooowwww ((((class SSSSttttaaaattttuuuussssWWWWiiiinnnnddddoooowwww)))) Use a popup window to show Xgopher status and activity. This contains usally one to three lines of text plus a cancel button. If this resource is false, then status is only shown in the status bar area just below the topmost row of buttons. The supplied default is True. nnnnaaaammmmeeeeTTTTeeeexxxxtttt ((((class NNNNaaaammmmeeeeTTTTeeeexxxxtttt)))) When this resource is true, a text window's icon will be given the name of the text item (as is in the window title bar). If false, each text window will have a common name, which is "Gopher Text" by default (this common icon label may also be changed using the resource Xgopher*textShell.iconName). The supplied default is True. mmmmaaaarrrrkkkkRRRRooooooootttt ((((class MMMMaaaarrrrkkkkRRRRooooooootttt)))) When true, a bookmark is automatically set at the top lever (root) directory. If you do not want to have this bookmark set, change the value of this resource to False. The supplied default is True. ccccoooonnnnccccuuuurrrrrrrreeeennnnttttTTTTeeeexxxxtttt ((((class CCCCoooonnnnccccuuuurrrrrrrreeeennnnttttTTTTeeeexxxxtttt)))) Normally each request for a text, help, or item information causes a new popup window to be displayed which remains displayed until it is dismissed with its "done" button. The number of windows displayed may be limited by setting this resource to a (usually small) number greater than zero. When number of windows displayed reaches this limit, the oldest will be reused for the next text to be shown. The window will be re-used in place without being popped down, yielding some time savings for slower or networked X servers. Also see commonText and allowHold. The supplied default is 0. ccccoooommmmmmmmoooonnnnTTTTeeeexxxxtttt ((((class CCCCoooommmmmmmmoooonnnnTTTTeeeexxxxtttt)))) Page 14 (printed 8/30/95) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555)))) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) There are three types of data displayed using a similar text window: gopher text files, xgopher help information, and item information from the "info" button. Each of these is normally considered a separate type of text popup for counting against the limit imposed by concurrentText. If commonText is True, then all three types of data are considered the same and together count against the limit. Also see concurrentText and allowHold. The supplied default is False. rrrreeeesssseeeettttOOOOppppttttiiiioooonnnnssss ((((class RRRReeeesssseeeettttOOOOppppttttiiiioooonnnnssss)))) Options changed on the options panel popup will be reset to their original default values when a restart command occurs if this resource is true. The supplied default is True. llllooooggggFFFFiiiilllleeee ((((class LLLLooooggggFFFFiiiilllleeee)))) If a file name is provided, all directory changes, remote host connections, and errors are logged to this file. If nothing else, it provides a trail of where you have been and allows some simple diagnostics to determine what remote machines are not accessible. If no file name is provided, no logging occurs. The supplied default is no log file. hhhhaaaassssSSSSoooouuuunnnndddd ((((class HHHHaaaassssSSSSoooouuuunnnndddd)))) This flag indicated whether the computer executing Xgopher has the ability to play general sounds, such as spoken words, sound effects, and music. For example, an X terminal will not normally have this ability, but some workstations such as the Sun SparcStation can play sounds. Note that if your display is remote from the computer with sound capability someone else may be deriving the benefit of your sound. Therefore this resource should indicate that sounds will be played nearby. The supplied default is False. EEEExxxxtttteeeennnnddddeeeedddd TTTTyyyyppppeeeessss For considerably more detail on extended types, their use, and examples, please see the document Extended- types that is part of the Xgopher source distribution. eeeexxxxtttteeeennnnddddeeeeddddTTTTyyyyppppeeeessss ((((class EEEExxxxtttteeeennnnddddeeeeddddTTTTyyyyppppeeeessss)))) A list of individual characters which represent additional gopher types to be processed by Xgopher. All internal types can be overridden Page 15 (printed 8/30/95) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555)))) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) by an extended type except directories and index directories (types 1 and 7). The types are processed and introduced to Xgopher in the order they are listed in this string. The supplied default is none. The following are sub-resources, each qualified by a name composed of the new extended type character. If X is an extended type, then each of the following resources is fully qualified as Xgopher.typeX._____. ssssaaaammmmeeeeAAAAssss ((((class SSSSaaaammmmeeeeAAAAssss)))) The letter identifier of an internal type or previously defined external type. This provides an alias saying that this new type is the same as some other type. However, the description, prefix, servers, and dataType may be different for this type. The supplied default is none. ddddeeeessssccccrrrriiiippppttttiiiioooonnnn ((((class DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn)))) A short string used in the info popup and status messages describing the type of this item. Typical names are "image file", "index search", etc. The supplied default is "type X item", where X is the extended type letter. pppprrrreeeeffffiiiixxxx ((((class PPPPrrrreeeeffffiiiixxxx)))) A menu display prefix string for items of this type. The supplied default is "< X >", where X is the extended type letter. sssseeeerrrrvvvveeeerrrrssss ((((class SSSSeeeerrrrvvvveeeerrrrssss)))) The gopher servers that can supply this item type. See "textServers" for more information. The supplied default is none. ddddaaaattttaaaaTTTTyyyyppppeeee ((((class DDDDaaaattttaaaaTTTTyyyyppppeeee)))) The type of data the gopher server will provide for this type. The values are None, Ascii, or Binary. None says that no additional data is provided, the execCommand is usually sufficient (an example is the telnet item type). Ascii or Binary determine the translations of the data received. Text type files should be specified as Ascii, image, sound, and similar data should be Binary. The supplied default is None. eeeexxxxeeeeccccCCCCoooommmmmmmmaaaannnndddd ((((class EEEExxxxeeeeccccCCCCoooommmmmmmmaaaannnndddd)))) The command to execute for processing this gopher item. Substitutions are made in this string in a manner similar to a C printf call. Page 16 (printed 8/30/95) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555)))) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) A percent sign signals the start of a replacement. The values used are taken verbatim from the gopher item. The following replacements are performed: %h hostname string %p port number %P if port number is 0 or 23, then blank, otherwise the port number. A hack for telnet sessions. %s selector (path) string %n name (menu name) string %f filename of the temp file string %% percent sign If any other character follows the percent, then no special substitution is performed. The supplied default is None. wwwwaaaaiiiitttt ((((class WWWWaaaaiiiitttt)))) If true, then the entire Xgopher application will await the completion of this process before continuing. If the execCommand forks itself and terminates, Xgopher may be easily deceived into believing that the process has completed before the task is really done. The supplied default is False. SSSSeeeeccccuuuurrrriiiittttyyyy aaaalllllllloooowwwwPPPPrrrriiiinnnntttt ((((class AAAAlllllllloooowwwwPPPPrrrriiiinnnntttt)))) If this boolean resource is true, text displayed in pop up windows may be spooled to a printer by depressing a _P_r_i_n_t button. If False, the button will not be displayed. The supplied default is True. aaaalllllllloooowwwwSSSSaaaavvvveeee ((((class AAAAlllllllloooowwwwSSSSaaaavvvveeee)))) If this boolean resource is true, text displayed in pop up windows may be saved to a user-specified file by depressing a _S_a_v_e button. If False, the button will not be displayed. The supplied default is True. aaaalllllllloooowwwwHHHHoooolllldddd ((((class aaaalllllllloooowwwwHHHHoooolllldddd)))) Page 17 (printed 8/30/95) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555)))) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) If concurrentText is greater than zero, requesting that the number of concurrent text windows is limited, a "hold" button will be added to each text pop-up window. If the hold button is pressed then this text window will be held on the screen until explicitly dismissed with the "done" button. This mechanism effectively overrides the concurrentText resource, and thus may be disabled by setting allowHold to False. Also see concurrentText and commonText. The supplied default is True. aaaalllllllloooowwwwTTTTeeeellllnnnneeeetttt ((((class AAAAlllllllloooowwwwTTTTeeeellllnnnneeeetttt)))) If this boolean resource is true, telnet sessions are allowed. If False, they are inhibited with an error message displayed to that effect. This resource should be False in secure environments such as public access terminals, as it is easy to start a shell from a telnet session. The supplied default is True. aaaalllllllloooowwwwTTTTnnnn3333222277770000 ((((class AAAAlllllllloooowwwwTTTTnnnn3333222277770000)))) If this boolean resource is true, tn3270 sessions are allowed. If False, they are inhibited with an error message displayed to that effect. This resource should be False in secure environments such as public access terminals, as it is easy to start a shell from a tn3270 session. The supplied default is True. aaaalllllllloooowwwwCCCCooooppppyyyy ((((class AAAAlllllllloooowwwwCCCCooooppppyyyy)))) If this boolean resource is true, the CCCCooooppppyyyy button is displayed and files may be directly copied to a user-specified file. Also, binary files may be fetched. If False, the button will not be displayed, and binary file access will be disallowed. The supplied default is True. aaaalllllllloooowwwwBBBBooooooookkkkmmmmaaaarrrrkkkkSSSSaaaavvvveeee ((((class AAAAlllllllloooowwwwBBBBooooooookkkkmmmmaaaarrrrkkkkSSSSaaaavvvveeee)))) The current bookmark list will be written to the current bookmark file when you exit or restart Xgopher if this resource is true. The bookmark file name may be changed during a session using the options panel. The supplied default is True. aaaalllllllloooowwwwIIIImmmmaaaaggggeeee ((((class AAAAlllllllloooowwwwIIIImmmmaaaaggggeeee)))) If this boolean resource is true, image display is allowed. If false, it is inhibited with an Page 18 (printed 8/30/95) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555)))) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) error message displayed to that effect. The supplied default is True. ooooppppttttiiiioooonnnnssssBBBBuuuuttttttttoooonnnn ((((class OOOOppppttttiiiioooonnnnssssBBBBuuuuttttttttoooonnnn)))) The OOOOppppttttiiiioooonnnnssss ppppaaaannnneeeellll button in the OOOOtttthhhheeeerrrr CCCCoooommmmmmmmaaaannnnddddssss menu will not be displayed if this resource is false. Then, no resources may be changed during a session. The supplied default is True. ssssiiiinnnngggglllleeeeIIIItttteeeemmmmBBBBuuuuttttttttoooonnnn ((((class SSSSiiiinnnngggglllleeeeIIIItttteeeemmmmBBBBuuuuttttttttoooonnnn)))) The EEEEnnnntttteeeerrrr ggggoooopppphhhheeeerrrr iiiitttteeeemmmm button in the OOOOtttthhhheeeerrrr CCCCoooommmmmmmmaaaannnnddddssss menu will not be displayed if this resource is false. Then, you cannot directly enter a gopher item descriptor. The supplied default is True. tttteeeexxxxttttSSSSeeeerrrrvvvveeeerrrrssss ((((class SSSSeeeerrrrvvvveeeerrrrssss))))"""" A list of trusted servers hosts or domains from which text files will be accepted. An empty list means that text files can be retrieved from any server. The list can contain host names, domain names, IP address numbers, or partial addresses that specify a domain. The list must contain exact names of the trusted hosts, no host aliases are used. This resource may be useful on a public-access system to prevent abuse or limit the extent of gopher space. If textServers is used, then it is prudent to also set allowFtp to False. The supplied default is none. iiiimmmmaaaaggggeeeeSSSSeeeerrrrvvvveeeerrrrssss ((((class SSSSeeeerrrrvvvveeeerrrrssss))))"""" Same as the textServers resource, but for image files. The supplied default is none. ssssoooouuuunnnnddddSSSSeeeerrrrvvvveeeerrrrssss ((((class SSSSeeeerrrrvvvveeeerrrrssss))))"""" Same as the textServers resource, but for sound files. The supplied default is none. aaaalllllllloooowwwwFFFFttttpppp ((((class AAAAlllllllloooowwwwFFFFttttpppp))))"""" Allow or disallow gopher accesses that specify an ftp request. This resource may be used to limit the extent of gopher space for a public- access Xgopher terminal. ppppuuuubbbblllliiiiccccMMMMooooddddeeee ((((class ppppuuuubbbblllliiiiccccMMMMooooddddeeee)))) This is more of a meta resource used to set many security-related resources at once. When set to True, publicMode sets the following values: Page 19 (printed 8/30/95) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555)))) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) Xgopher.allowSave: False Xgopher.allowPrint: False Xgopher.allowTelnet: False Xgopher.allowTn3270: False Xgopher.allowBookmarkSave: False Xgopher.allowCopy: False Xgopher.appendBookmarks: True Xgopher.loadBookmarks: True Xgopher.markRoot: True Xgopher.resetOptions: True Xgopher.optionsButton: False Xgopher.singleItemButton: False Xgopher.showItems: Available You should also consider setting the following which are NOT automatically set by publicMode: Xgopher.allowImage: False Xgopher.hasSound: False (or use imageServers/soundServers to control access), Xgopher.warpCursor: True Xgopher.doubleClick: False Xgopher.concurrentText: 1 Xgopher.allowHold: False Xgopher.allowFtp: False Xgopher.bookmarkFile: <filename> the next two should go as a pair: Xgopher.restartButton: False Xgopher.swapRestartAndQuit: True Also, be sure that any remaining commands (imageCommand, soundCommand, etc.) have no shell- escapes or other ways to do damage. rrrreeeessssttttaaaarrrrttttBBBBuuuuttttttttoooonnnn ((((class RRRReeeessssttttaaaarrrrttttBBBBuuuuttttttttoooonnnn)))) If false, the RRRReeeessssttttaaaarrrrtttt command button in the OOOOtttthhhheeeerrrr OOOOppppttttiiiioooonnnnssss menu will not be displayed. This is most useful in conjunction with the sssswwwwaaaappppRRRReeeessssttttaaaarrrrttttAAAAnnnnddddQQQQuuuuiiiitttt resource. The supplied default is True. sssswwwwaaaappppRRRReeeessssttttaaaarrrrttttAAAAnnnnddddQQQQuuuuiiiitttt ((((class SSSSwwwwaaaappppRRRReeeessssttttaaaarrrrttttAAAAnnnnddddQQQQuuuuiiiitttt)))) If true, the functions of the quit and restart buttons are swapped. Remember to also change the button labels. This may be used in a public-access Xgopher terminal to easily retreat to a known state, but not-too-easily terminate Xgopher entirely. The supplied default is False. Page 20 (printed 8/30/95) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555)))) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) PPPPooooppppuuuupppp PPPPoooossssiiiittttiiiioooonnnniiiinnnngggg For considerably more detail on positioning popup windows, including examples, please see the document Popups that is part of the Xgopher source distribution. The following are sub-resources, each qualified by a name of a popup, for example, Xgopher.Popup._____. ppppoooossssiiiittttiiiioooonnnnFFFFrrrroooommmm ((((class PPPPoooossssiiiittttiiiioooonnnnFFFFrrrroooommmm)))) The supplied default is from_none. xxxxPPPPoooossssiiiittttiiiioooonnnn ((((class PPPPoooossssiiiittttiiiioooonnnn)))) The supplied default is 0. yyyyPPPPoooossssiiiittttiiiioooonnnn ((((class PPPPoooossssiiiittttiiiioooonnnn)))) The supplied default is 0. hhhhoooorrrriiiizzzzoooonnnnttttaaaallllJJJJuuuussssttttiiiiffffiiiiccccaaaattttiiiioooonnnn ((((class JJJJuuuussssttttiiiiffffiiiiccccaaaattttiiiioooonnnn)))) The supplied default is Left. vvvveeeerrrrttttiiiiccccaaaallllJJJJuuuussssttttiiiiffffiiiiccccaaaattttiiiioooonnnn ((((class JJJJuuuussssttttiiiiffffiiiiccccaaaattttiiiioooonnnn)))) The supplied default is Top. xxxxPPPPeeeerrrrcccceeeennnntttt ((((class PPPPeeeerrrrcccceeeennnntttt)))) The supplied default is True. yyyyPPPPeeeerrrrcccceeeennnntttt ((((class PPPPeeeerrrrcccceeeennnntttt)))) The supplied default is True. PPPPrrrreeeeffffiiiixxxxeeeessss pppprrrreeeeffffiiiixxxxFFFFiiiilllleeee ((((class PPPPrrrreeeeffffiiiixxxxFFFFiiiilllleeee)))) This prefix is shown in the directory listing to the left of text files. The supplied default is blank for text files. pppprrrreeeeffffiiiixxxxDDDDiiiirrrr ((((class PPPPrrrreeeeffffiiiixxxxDDDDiiiirrrr)))) This prefix is shown in the directory listing to the left of directory entries. The supplied default is 273 (an octal escape sequence), which is a single character in the Latin-1 character set which looks like >>. pppprrrreeeeffffiiiixxxxCCCCSSSSOOOO ((((class PPPPrrrreeeeffffiiiixxxxCCCCSSSSOOOO)))) This prefix is shown in the directory listing to the left of entries which are CSO name servers (phone books). The supplied default is <cso>. pppprrrreeeeffffiiiixxxxTTTTeeeellllnnnneeeetttt ((((class PPPPrrrreeeeffffiiiixxxxTTTTeeeellllnnnneeeetttt)))) This prefix is shown in the directory listing Page 21 (printed 8/30/95) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555)))) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) to the left of entries which are telnet sessions. The supplied default is <tel>. pppprrrreeeeffffiiiixxxxTTTTnnnn3333222277770000 ((((class PPPPrrrreeeeffffiiiixxxxTTTTnnnn3333222277770000)))) This prefix is shown in the directory listing to the left of entries which are tn3270 sessions. The supplied default is <tn3>. pppprrrreeeeffffiiiixxxxIIIInnnnddddeeeexxxx ((((class PPPPrrrreeeeffffiiiixxxxIIIInnnnddddeeeexxxx)))) This prefix is shown in the directory listing to the left of entries which are full text index searches. The supplied default is <idx>. pppprrrreeeeffffiiiixxxxIIIImmmmaaaaggggeeee ((((class PPPPrrrreeeeffffiiiixxxxIIIImmmmaaaaggggeeee)))) This prefix is shown in the directory listing to the left of entries which are image files. The supplied default is <img>. pppprrrreeeeffffiiiixxxxBBBBiiiinnnnaaaarrrryyyy ((((class PPPPrrrreeeeffffiiiixxxxBBBBiiiinnnnaaaarrrryyyy)))) This prefix is shown in the directory listing to the left of entries which are binary files. The supplied default is <bin>. pppprrrreeeeffffiiiixxxxSSSSoooouuuunnnndddd ((((class PPPPrrrreeeeffffiiiixxxxSSSSoooouuuunnnndddd)))) This prefix is shown in the directory listing to the left of entries which are sound files. The supplied default is <snd>. pppprrrreeeeffffiiiixxxxUUUUnnnnkkkknnnnoooowwwwnnnn ((((class PPPPrrrreeeeffffiiiixxxxUUUUnnnnkkkknnnnoooowwwwnnnn)))) This prefix is shown in the directory listing to the left of entries which are unknown file types. This prefix is displayed if sssshhhhoooowwwwIIIItttteeeemmmmssss is All or Accessible. The supplied default is < ? >. PPPPeeeerrrrffffoooorrrrmmmmaaaannnncccceeee aaaannnndddd CCCCoooonnnnffffiiiigggguuuurrrraaaattttiiiioooonnnn ddddiiiirrrreeeeccccttttoooorrrryyyyTTTTiiiimmmmeeee ((((class DDDDiiiirrrreeeeccccttttoooorrrryyyyTTTTiiiimmmmeeee)))) Directory entries for all active directories (current directory, directories with bookmarks, and all of their ancestors) are saved for this many seconds. After this time, their contents are released and re-requested from the appropriate place when needed. This caching of directory contents makes moving up the directory tree and jumping to bookmarks quite fast. The very small potential risk is that the contents of a directory in a gopher server may be changed while the directory is stored. The caching, freeing, and reloading of directories is transparent to the user. The supplied default is 600. This is 10 minutes. Page 22 (printed 8/30/95) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555)))) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) iiiitttteeeemmmmSSSSttttaaaarrrrtttt ((((class IIIItttteeeemmmmSSSSttttaaaarrrrtttt)))) Not normally changed by the user, this determines the amount of memory dynamically allocated when xgopher starts execution to hold gopher items (directory contents). The supplied default is 500. iiiitttteeeemmmmIIIInnnnccccrrrreeeemmmmeeeennnntttt ((((class IIIItttteeeemmmmIIIInnnnccccrrrreeeemmmmeeeennnntttt)))) Not normally changed by the user, this determines the amount of memory dynamically allocated each time xgopher needs additional memory to hold gopher items (directory contents). The supplied default is 50. ddddiiiirrrrSSSSttttaaaarrrrtttt ((((class DDDDiiiirrrrSSSSttttaaaarrrrtttt)))) Not normally changed by the user, this determines the amount of memory dynamically allocated when xgopher starts execution to hold gopher directories. The supplied default is 50. ddddiiiirrrrIIIInnnnccccrrrreeeemmmmeeeennnntttt ((((class DDDDiiiirrrrIIIInnnnccccrrrreeeemmmmeeeennnntttt)))) Not normally changed by the user, this determines the amount of memory dynamically allocated each time xgopher needs additional memory to hold gopher directories. The supplied default is 10. tttteeeemmmmppppDDDDiiiirrrreeeeccccttttoooorrrryyyy ((((class TTTTeeeemmmmppppDDDDiiiirrrreeeeccccttttoooorrrryyyy)))) The directory for xgopher to create files that it will need for display or other purposes, but will not exist beyond this xgopher session. The supplied default is /tmp. WWWWiiiiddddggggeeeetttt ssssppppeeeecccciiiiffffiiiicccc rrrreeeessssoooouuuurrrrcccceeeessss:::: The X Toolkit and Athena Widgets documentation covers the widget specific resources. The most significant widget specific resources are mentioned here. ffffoooonnnntttt ((((class FFFFoooonnnntttt)))) All text, label, and command button widgets have a font that can be selected. llllaaaabbbbeeeellll ((((class LLLLaaaabbbbeeeellll)))) All command button widgets and many labels text strings may be changed, for example to another language. FFFFIIIILLLLEEEESSSS /usr/local/lib/X11/app-defaults/Xgopher Page 23 (printed 8/30/95) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 5555)))) XXXXGGGGOOOOPPPPHHHHEEEERRRR((((1111)))) /usr/local/lib/X11/xgopher.help SSSSEEEEEEEE AAAALLLLSSSSOOOO There is a collection of documents included with the Xgopher distribution that may be useful to the installer or users of Xgopher. These include guides for porting Xgopher, defining new gopher types for Xgopher, and notes that will aid in customization an Xgopher environment. Installers should see the internal documentation for changes to the configuration file before compiling and installing Xgopher. BBBBUUUUGGGGSSSS The gopher+ protocol is not yet supported. CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT Copyright 1992, 1993 by the Board of Trustees of the University of Illinois This program with copyright notice intact may be freely distributed without permission. AAAAUUUUTTTTHHHHOOOORRRR Allan Tuchman, Computing and Communications Services Office, University of Illinois at Urbana-Champaign, Urbana, Illinois, USA. email to: a-tuchman@uiuc.edu. Page 24 (printed 8/30/95) 
